.TH E1432_SET_WEIGHTING 3 E1432
.SH NAME
.nf
e1432_set_weighting \- Set input weighting filter
e1432_get_weighting \- Get current input weighting filter
.fi
.IX e1432_set_weighting(3) 3
.IX e1432_get_weighting(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_weighting(E1432ID hw, SHORTSIZ16 ID,
                               SHORTSIZ16 weighting)
SHORTSIZ16 e1432_get_weighting(E1432ID hw, SHORTSIZ16 ID,
                               SHORTSIZ16 *weighting)
.cE
.SH DESCRIPTION

\fIe1432_set_weighting\fR sets the input weighting filter of a single
channel or group of channels \fIID\fR, to the value given in
\fIweighting\fR.

\fIe1432_get_weighting\fR returns the current input
weighting filter, of a single channel or group of channels \fIID\fR,
into a memory location pointed to by \fIweighting\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.

\fIweighting\fR must be one of the following:
\fBE1432_WEIGHTING_OFF\fR to turn the weighting filter off,
\fBE1432_WEIGHTING_A\fR for the A weighting filter,
\fBE1432_WEIGHTING_B\fR for the B weighting filter,
\fBE1432_WEIGHTING_C\fR for the C weighting filter.

Weighting filter settings other than \fBE1432_WEIGHTING_OFF\fR are
only available at clock frequencies of 51200 and 65536 Hz.

Weighting filters are currently available only on the E1433.  They are
applied by a time-domain filter, so they affect both time and
frequency domain data from the E1433 module.

The weighting filters are applied prior to Peak and RMS computations.
Therefore, the values returned by \fIe1432_get_current_value\fR,
as well as the peak and rms value entries in the trailer
(see \fIe1432_set_append_status\fR) have the weighting applied.

If this parameter is changed while a measurement is running, it will
not have any effect until the start of the next measurement.
.SH "RESET VALUE"
After a reset, the \fIweighting\fR is set to \fBE1432_WEIGHTING_OFF\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_clock_freq, e1432_set_peak_mode, e1432_set_rms_mode,
e1432_set_peak_decay_time, e1432_set_rms_avg_time,
e1432_set_rms_decay_time, e1432_get_current_value,
e1432_set_append_status.
.ad
